home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 26 / AACD 26.iso / AACD / Games / WHDLoad / Src / sources / whdload / kick13.readme < prev    next >
Encoding:
Text File  |  2001-09-20  |  3.9 KB  |  134 lines
  1.  
  2. important changes:
  3.  
  4. NOFPU changed to NEEDFPU
  5. no longer disk present in any drive by default, see DISKSONBOOT
  6.  
  7. $Id: kick13.readme 1.1 2001/09/01 22:09:18 wepl Exp $
  8.  
  9. Symbols in the Slave-Source
  10. ***************************
  11.  
  12. There are two classes of Symbols to define in the Slave-Source. The first
  13. class must be specified to setup essential informations for the system. The
  14. second class contains optional Symbols changing some behaviors of the
  15. emulation.
  16.  
  17.  
  18. Required Symbols
  19. ----------------
  20.  
  21. CHIPMEMSIZE = $80000
  22.  
  23. That specfies the amount of Chip-Memory for the system. Allowed values are
  24. between $1000 and $200000. It is recommended to start with a full value like
  25. $80000 or $100000, and later to adjust that value to the minimum required
  26. using the MEMFREE feature (see below).
  27.  
  28. FASTMEMSIZE = $10000
  29.  
  30. That specifies the Fast-Memory (better to say ExpMem because it can be ChipMem
  31. too if not enough FastMem is available) for the system. Allowed values are
  32. 0 upto any what WHDLoad supports.
  33.  
  34. NUMDRIVES = 1
  35.  
  36. That sets the number of drives available in the system. Allowed values are
  37. 0 - 4. The value 0 has special meaning that Custom1/N is used to set drive
  38. count.
  39.  
  40. WPDRIVES = %0000
  41.  
  42. That sets the protections state for the emulated floppy drives. Bit #0 means
  43. drive DF0: and the value 0 means 'write protected' and 1 means 'read/write'.
  44.  
  45.  
  46. Optional Symbols
  47. ----------------
  48.  
  49. BLACKSCREEN
  50.  
  51. That symbol forces all colors (0-4,17-19) in the default system (intuition)
  52. preferences to null. The result is that the initial AmigaDOS boot screen will
  53. be invisible.
  54.  
  55. DISKSONBOOT
  56.  
  57. If that symbol is defined there will be disks inserted in the drives at
  58. booting time. Otherwise all drives will be empty. If the symbol is set DF0:
  59. will contain 'Disk.1', DF1: 'Disk.2' an so on.
  60.  
  61. HRTMON
  62.  
  63. The presence of that symbol adds some debugging support for HrtMon. HrtMon
  64. reads to much from the stackframe if entered. If the SSP is at the end of the
  65. memory that will cause an access fault. The symbol results in a decremented
  66. SSP.
  67.  
  68. MEMFREE = $100
  69.  
  70. If this symbol is defined the function exec.AllocMem will be patched. At each
  71. call to this function the size of the largest free memory chunk will be
  72. calculated and saved at the specified address if lower than the previous one.
  73. Using this feature it is absolutely simple to optimize the memory requirements
  74. and avoid memory wasting. Test a game trough all paths with that symbol
  75. defined. Then make a dump and checkout the memory dump file. At address 
  76. (MEMFREE) you will find the lowest free chip memory during the games lifetime.
  77. At address (MEMFREE+4) you will find the same for fast memory.
  78.  
  79. NEEDFPU
  80.  
  81. If that symbol is defined the system will get informed if an FPU is preset
  82. (execbase.AttnFlags). If the symbol is not defined the system will think there
  83. is no FPU regardless if there is one really. The system will use a different
  84. task switching routine which will save also the FPU registers if a FPU is
  85. present.
  86.  
  87. SETPATCH
  88.  
  89. If that symbol is defined nearly all patches done by the SetPatch v1.38
  90. program will be performed. Usually that is not necessary and omitting the
  91. option makes the Slave around 400 bytes shorter.
  92.  
  93.  
  94. Labels in the Slave-Source
  95. **************************
  96.  
  97. All boot entry vectors terminate the boot process! That means you cannot
  98. continue using a RTS or similar from the boot entry vector.
  99.  
  100. _bootearly
  101.  
  102.     *
  103.     
  104. _bootblock
  105.  
  106.     * will be entered after the bootblock has been loaded from the disk in
  107.       drive DF0:, that is the point at which Kickstart normally jumps into
  108.       bootblock
  109.  
  110.     * Registers:
  111.       A1 = ioreq
  112.       A4 = buffer which contains the loaded bootblock (1024 bytes)
  113.       A6 = execbase
  114.  
  115.     * NO dos.library exists at this time!
  116.     
  117. _bootdos
  118.  
  119.     * will be entered short before the S:Startup-Sequence will be loaded
  120.       and executed
  121.  
  122.     * dos.library is fully initialized and usable
  123.  
  124.  
  125. _cb_dosLoadSeg
  126.  
  127. Functions in kick13.s
  128. *********************
  129.  
  130.     ;d0.b = unit
  131.     ;d1.b = new disk image number
  132. _trd_changedisk
  133.  
  134.